Node / meshtastic / Meshtastic-Android / files / docs / ja-rJP / user / mqtt.md

Displaying Rendered • View raw • Download

title: MQTT

parent: User Guide

nav_order: 11

last_updated: 2026-05-13

description: メッシュをインターネットに橋渡しします。MQTT サーバーの設定、暗号化の各レイヤー、マップ報告について説明します。

aliases:

• mqtt

• internet-bridge

• broker

MQTT は、Meshtastic のメッシュネットワークをインターネットに橋渡しし、無線の到達範囲を超えた長距離通信を可能にします。

MQTT モジュールは、ノードを MQTT サーバーに接続し、次のことを可能にします：

• インターネット経由で、物理的に異なるメッシュ上のノードにメッセージを届ける

• ホームオートメーションや監視システムとの連携

• ノードの位置を公開の Meshtastic マップに公開する

• ログ記録や通知のためのカスタムデータパイプライン

T282828

インターネットに接続されたゲートウェイノード（WiFi または Ethernet）が、メッシュのメッセージを MQTT トピックに公開します。 同じトピックを購読しているリモートのゲートウェイが、それらのメッセージを自分のローカルメッシュに取り込みます。

1. 「設定 → モジュール設定 → MQTT」に移動します。

2. MQTT モジュールを有効にします。

3. サーバーへの接続を設定します：

!MQTT のトグルスイッチ

ノード自体がインターネットに接続できない場合、接続中のスマートフォンを MQTT ゲートウェイとして使えます。モジュール設定で「MQTT」と「クライアントへのプロキシを有効化」を有効にすると、アプリがスマートフォンのインターネット接続を通じて、無線機とサーバーの間で MQTT の通信を中継します。

MQTT 設定画面の上部にある「このスマートフォンでの MQTT プロキシ」トグルは、この中継が現在動作しているかどうかを示し、デバイスの MQTT 設定を編集して保存し直すことなく、すぐに停止（または再開）できます。

コミュニティが T383838mqtt.meshtastic.org で公開サーバーを運用しています。 これは一般的な利用やテストを目的としています。

│ ℹ️ 注意： T383838mqtt.meshtastic.org への接続は、TLS のトグルがオフでも常に TLS（ポート

│ 8883）を使用します。 それ以外のサーバーでは、TLS は有効にした場合にのみ使用されます（TLS

│ ありはポート 8883、なしは 1883）。

│ 🔒 プライバシー： 公開サーバー上のメッセージは、購読している誰もが読めます。

│ プライベートな通信には、必ずチャンネルの暗号化を使用してください。

プライバシーと制御を高めるために、独自の MQTT サーバーを運用できます：

• Mosquitto（軽量、オープンソース）

• HiveMQ

• EMQX

適切な認証情報を設定して、ノードがプライベートサーバーに接続するよう構成します。

マップ報告を有効にすると、ノードは自分の位置を Meshtastic のコミュニティマップに公開します：

• meshmap.net や、同様のコミュニティマップサービスで表示されます

• 共有されるのは位置とノード情報のみです

• 位置を公開したくない場合は、これを無効にしてください

メッセージの流れと電波利用時間を制御するため、どの方向を有効にするかをチャンネルごとに設定します。

MQTT は protobuf のメッセージ形式を使用します：

│ ⚠️ 注意： JSON 出力のサポートはファームウェアから削除されました。 T383838json_enabled

│ の設定は、以前との互換性のためにアプリ上には表示されますが、現在のファームウェアバージョンには影

│ 響しません。

階層化された暗号化モデルを理解する：

1. チャンネルの暗号化は、MQTT の前にメッシュ上で行われます。 チャンネルに PSK が設定されている場合、MQTT ペイロードはすでに暗号化されています。サーバーや購読者には暗号文しか見えません。

2. MQTT の暗号化（モジュールの設定）は、サーバーへの転送のために追加の暗号化レイヤーを加えます。 これはメタデータやルーティング情報を保護します。

3. TLS はサーバーへの TCP 接続自体を暗号化し、ネットワークレベルの盗聴を防ぎます。

│ 🔒 重要： デフォルトの公開チャンネルは、よく知られた鍵を使用しています。 デフォルトチャンネルで

│ MQTT 経由で送信されるメッセージは、実質的に暗号化されていません。誰でも解読できます。

│ プライベートな通信には、必ずカスタムの PSK を使用してください。

• MQTT に橋渡しするチャンネルでは、チャンネルレベルの暗号化（PSK）を使用します

• インターネットに接続できないノードでは MQTT を有効にしないでください（バッファリングしてメモリを浪費します）

• 機密性の高い運用にはプライベートサーバーを使用します

• 混雑した MQTT トピックからメッセージをダウンリンクする際は、電波利用時間に注意してください。ダウンリンクされたメッセージはすべて、ローカルメッシュの無線の電波利用時間を消費します

• メッセージを送り返さず、リモートでメッシュを監視するだけでよい場合は、アップリンクのみを有効にすることを検討してください

• WiFi を確認： ゲートウェイノードには、有効なインターネット接続（WiFi または Ethernet）が必要です。 MQTT は LoRa の無線リンク自体では動作しません。

• 認証情報を確認： ユーザー名やパスワードが正しくないと、ほとんどのサーバーでは何も表示されずに失敗します。 末尾のスペースがないか、よく確認してください。

• ファイアウォール： ポート 1883（MQTT）または 8883（MQTT+TLS）が開いている必要があります。 一部のネットワークは、標準外のポートをブロックします。

• DNS 解決： カスタムのサーバーホスト名を使う場合は、ノードがそれを解決できるか確認してください。 サーバーの IP アドレスを直接試してみてください。

• アップリンク／ダウンリンクの設定を確認： アップリンクのみが有効な場合、メッセージはメッシュから MQTT へ流れますが、戻ってきません。 受信側のゲートウェイでダウンリンクを有効にしてください。

• チャンネルの不一致： 両方のゲートウェイが、同じ PSK を持つ同じチャンネルを共有している必要があります。 不一致の場合、メッセージは異なる鍵で暗号化され、判読できないデータとして表示されます。

• トピックの不一致： 両方のゲートウェイが同じルートトピックを使用しているか確認してください。 デフォルトの T383838msh は公開サーバーで機能します。

• 設定：モジュールと管理：MQTT モジュールの設定リファレンス

• メッセージとチャンネル：チャンネルの暗号化と PSK の設定

• MQTT 連携ガイド：meshtastic.org にある詳細な MQTT ドキュメント